﻿@{
    Layout = "~/Views/Shared/_LayoutWiki.cshtml";
}

<h2>手机接口操作</h2>

<div class="item">
    <h3>生成导购引流二维码</h3>

    <p>请求说明</p>
    <p>http请求方式: get</p>
    <p>http://hub.engnice.com/scrm/app/getqrcode</p>

    <p>返回说明</p>
    <table>
        <tr>
            <th>参数</th>
            <th>类型</th>
            <th>说明</th>
        </tr>
        <tr>
            <td>data</td>
            <td>json</td>
            <td>二维码信息</td>
        </tr>
        <tr>
            <td>data.url</td>
            <td>string</td>
            <td>图片地址</td>
        </tr>
        <tr>
            <td>data.sceneid</td>
            <td>int</td>
            <td>二维码标识</td>
        </tr>
    </table>
</div>

<div class="item">
    <h3>根据二维码标识读取信息</h3>

    <p>该接口需要使用长轮询形式调用，每次请求时间上限25秒左右，如果微信有扫码会即时反馈。</p>

    <p>请求说明</p>
    <p>http请求方式: get</p>
    <p>http://hub.engnice.com/scrm/app/getqrcoderesult</p>

    <p>参数说明</p>
    <table>
        <tr>
            <th>参数</th>
            <th>是否必须</th>
            <th>说明</th>
        </tr>
        <tr>
            <td>sceneid</td>
            <td>是</td>
            <td>二维码标识（int类型，由“生成导购引流二维码”接口返回）。</td>
        </tr>
    </table>

    <p>返回说明</p>
    <table>
        <tr>
            <th>参数</th>
            <th>类型</th>
            <th>说明</th>
        </tr>
        <tr>
            <td>data</td>
            <td>json</td>
            <td>状态信息</td>
        </tr>
        <tr>
            <td>data.status</td>
            <td>string</td>
            <td>二维码状态，等待扫码时为wait，此时应重复请求，扫码成功为complete，此时可以取到openid并进行下一步骤。</td>
        </tr>
        <tr>
            <td>data.openid</td>
            <td>string</td>
            <td>用户微信编号，状态为complete时可以取到此参数。</td>
        </tr>
    </table>
</div>

<div class="item">
    <h3>设置二维码状态</h3>

    <p>该接口主要提供给微信服务端事件触发，手机端无需调用。</p>

    <p>请求说明</p>
    <p>http请求方式: get</p>
    <p>http://hub.engnice.com/scrm/app/setqrcoderesult</p>

    <p>参数说明</p>
    <table>
        <tr>
            <th>参数</th>
            <th>是否必须</th>
            <th>说明</th>
        </tr>
        <tr>
            <td>sceneid</td>
            <td>是</td>
            <td>二维码标识</td>
        </tr>
        <tr>
            <td>openid</td>
            <td>是</td>
            <td>用户微信标识</td>
        </tr>
    </table>
</div>